Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 10 - Group Objects / Group Objects Reference

Group Objects Routines / Getting Group Positions

Q3Group_GetNextPosition

You can use the Q3Group_GetNextPosition function to get the position of the next object in a group.

TQ3Status Q3Group_GetNextPosition (
TQ3GroupObject group, 
TQ3GroupPosition *position);

group

A group.

position

On entry, a pointer to a valid group position. On exit, a pointer to the position in the specified group of the object that immediately follows the object in that position.

DESCRIPTION

The Q3Group_GetNextPosition function returns, in the position parameter, the position in the group specified by the group parameter of the object that immediately follows the object having the position specified on entry in the position parameter. If the object specified on entry is the last object in the group, Q3Group_GetNextPosition returns the value NULL in the position parameter.

ERRORS

kQ3ErrorInvalidObject
kQ3ErrorInvalidPositionForGroup
kQ3ErrorNULLParameter